<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--

    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.

-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<title>Add Exception Dialog Box</title>
<link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/>
</head>

<body>
<p><a id="org.netbeans.modules.web.struts.dialogs.AddExceptionDialogPanel" name="org.netbeans.modules.web.struts.dialogs.AddExceptionDialogPanel"></a></p>
<div id="NBCSH4229"><!-- infolevel="all" infotype="General" --><a id="sthref562" name="sthref562"></a>
<h1>Add Exception Dialog Box</h1>
<a name="BEGIN" id="BEGIN"></a>
<p>Use to register an exception handler in the <code dir="ltr">struts-config.xml</code> file. You open the Add Exception dialog box by right-clicking in a <code dir="ltr">struts-config.xml</code> file and choosing <b>Struts</b> &gt; <b>Add Exception</b>. 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1189">
<param name="text" value="<html><u>How?</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p>A Struts exception handler lets you declaratively handle exceptions in the <code dir="ltr">struts-config.xml</code> file. Instead of solving exceptions in Java code, you can specify the resource that should deal with the exception. You can also specify the message that should be displayed to the user when an exception occurs. You can fine tune exception handling by providing a different solution for each type of exception or you can let all exceptions be handled in the same way. 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1188">
<param name="text" value="<html><u>More</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p>In the Add Exception dialog box, you set the following properties:</p>

<table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<col width="24%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t13">Element</th>
<th align="left" valign="bottom" id="r1c2-t13">Description</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t13" headers="r1c1-t13">
<p>Resource Bundle</p>
</td>
<td align="left" headers="r2c1-t13 r1c2-t13">Specifies the servlet context attribute for the message resources bundle associated with this handler. The default attribute is the value specified by the string constant declared at <code dir="ltr">Globals.MESSAGES_KEY</code>.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t13" headers="r1c1-t13">
<p>Bundle Key</p>
</td>
<td align="left" headers="r3c1-t13 r1c2-t13">Specifies the name of the key in the resource bundle that identifies the message to be displayed to the user.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t13" headers="r1c1-t13">
<p>Exception Type</p>
</td>
<td align="left" headers="r4c1-t13 r1c2-t13">Specifies the type of exception that must occur for the exception handler to be used.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r5c1-t13" headers="r1c1-t13">
<p>Call</p>
</td>
<td align="left" headers="r5c1-t13 r1c2-t13"></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r6c1-t13" headers="r1c1-t13">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Resource File</p>
</td>
<td align="left" headers="r6c1-t13 r1c2-t13">Specifies the resource file that will handle the exception. For example, if a JSP page is set as the resource file, Struts will display the specified JSP page when the exception occurs.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r7c1-t13" headers="r1c1-t13">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Action</p>
</td>
<td align="left" headers="r7c1-t13 r1c2-t13">Specifies the action that will handle the exception.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r8c1-t13" headers="r1c1-t13">
<p>Scope</p>
</td>
<td align="left" headers="r8c1-t13 r1c2-t13">Specifies the scope within which the exception handler is applicable. By default, the exception handler is set to Session scope.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r9c1-t13" headers="r1c1-t13">
<p>Location</p>
</td>
<td align="left" headers="r9c1-t13 r1c2-t13"></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r10c1-t13" headers="r1c1-t13">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Global</p>
</td>
<td align="left" headers="r10c1-t13 r1c2-t13">Specifies that the exception handler applies to all actions.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r11c1-t13" headers="r1c1-t13">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Action</p>
</td>
<td align="left" headers="r11c1-t13 r1c2-t13">Specifies the specific action to which the exception handler applies.</td>
</tr>
</tbody>
</table>
<br />
<!-- -->
<p>Note: If you want to change a registered exception handler, you can do so by manually editing the XML tags in the <code dir="ltr">struts-config.xml</code> file.</p>
<a id="NBCSH4240" name="NBCSH4240"></a>
<hr><p><b>Related Topics</b></p>
<p><i>Developing Applications with NetBeans IDE</i>, 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1188">
<param name="text" value="<html><u>&quot;Working with the Struts Framework&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p><i>Developing Applications with NetBeans IDE</i>, 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1140">
<param name="text" value="<html><u>&quot;About Using Web Application Frameworks&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>

<!-- -->
<!-- Start Footer -->


<table summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="legal_notice.htm">
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a>
</td>
</tr>
</table>
<!-- -->
</body>
</html>
